<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Poppler-0.87.0
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;10.&nbsp;Graphics and Font Libraries
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="pixman.html" title="Pixman-0.38.4">Prev</a>
          <p>
            Pixman-0.38.4
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="potrace.html" title="Potrace-1.16">Next</a>
          <p>
            Potrace-1.16
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="graphlib.html" title=
          "Chapter&nbsp;10.&nbsp;Graphics and Font Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="poppler" name="poppler"></a>Poppler-0.87.0
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Poppler
        </h2>
        <p>
          The <span class="application">Poppler</span> package contains a PDF
          rendering library and command line tools used to manipulate PDF
          files. This is useful for providing PDF rendering functionality as
          a shared library.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://poppler.freedesktop.org/poppler-0.87.0.tar.xz">https://poppler.freedesktop.org/poppler-0.87.0.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: fc1300ea104893f21926c7f1eb7a18ac
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 1.5 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 78 MB (with Qt5 library and
                tests)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.7 SBU (with parallelism=4, Qt5
                library, and tests)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Additional Downloads
        </h3>
        <div class="itemizedlist">
          <p class="title">
            <strong>Poppler Encoding Data</strong>
          </p>
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://poppler.freedesktop.org/poppler-data-0.4.9.tar.gz">https://poppler.freedesktop.org/poppler-data-0.4.9.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 35cc7beba00aa174631466f06732be40
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 4.1 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 13 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: less than 0.1 SBU
              </p>
            </li>
          </ul>
        </div>
        <p>
          The additional package consists of encoding files for use with
          <span class="application">Poppler</span>. The encoding files are
          optional and <span class="application">Poppler</span> will
          automatically read them if they are present. When installed, they
          enable <span class="application">Poppler</span> to render CJK and
          Cyrillic properly.
        </p>
        <h3>
          Poppler Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="cmake.html" title=
          "CMake-3.17.0">CMake-3.17.0</a> and <a class="xref" href=
          "fontconfig.html" title="Fontconfig-2.13.1">Fontconfig-2.13.1</a>
        </p>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="../x/cairo.html" title=
          "Cairo-1.17.2+f93fc72c03e">Cairo-1.17.2+f93fc72c03e</a>, <a class=
          "xref" href="lcms2.html" title="Little CMS-2.9">Little CMS-2.9</a>,
          <a class="xref" href="libjpeg.html" title=
          "libjpeg-turbo-2.0.4">libjpeg-turbo-2.0.4</a>, <a class="xref"
          href="libpng.html" title="libpng-1.6.37">libpng-1.6.37</a>,
          <a class="xref" href="../postlfs/nss.html" title=
          "NSS-3.51">NSS-3.51</a>, and <a class="xref" href="openjpeg2.html"
          title="OpenJPEG-2.3.1">OpenJPEG-2.3.1</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="boost.html" title=
          "Boost-1.72.0">Boost-1.72.0</a>, <a class="xref" href=
          "../basicnet/curl.html" title="cURL-7.69.1">cURL-7.69.1</a>,
          <a class="xref" href="../x/gdk-pixbuf.html" title=
          "gdk-pixbuf-2.40.0">gdk-pixbuf-2.40.0</a>, <a class="xref" href=
          "git.html" title="Git-2.26.0">git-2.26.0</a> (for downloading test
          files), <a class="xref" href="gobject-introspection.html" title=
          "gobject-introspection-1.64.0">gobject-introspection-1.64.0</a>,
          <a class="xref" href="gtk-doc.html" title=
          "GTK-Doc-1.32">GTK-Doc-1.32</a>, <a class="xref" href=
          "../x/gtk3.html" title="GTK+-3.24.16">GTK+-3.24.16</a>, <a class=
          "xref" href="libtiff.html" title="LibTIFF-4.1.0">LibTIFF-4.1.0</a>,
          and <a class="xref" href="../x/qt5.html" title=
          "Qt-5.14.1">Qt-5.14.1</a> (required for PDF support in <a class=
          "xref" href="../kde/okular5.html" title=
          "Okular-19.12.2">Okular-19.12.2</a>)
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/poppler">http://wiki.linuxfromscratch.org/blfs/wiki/poppler</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Poppler
        </h2>
        <p>
          Install <span class="application">Poppler</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">mkdir build                         &amp;&amp;
cd    build                         &amp;&amp;

cmake  -DCMAKE_BUILD_TYPE=Release   \
       -DCMAKE_INSTALL_PREFIX=/usr  \
       -DTESTDATADIR=$PWD/testfiles \
       -DENABLE_UNSTABLE_API_ABI_HEADERS=ON     \
       ..                           &amp;&amp;
make</kbd>
</pre>
        <p>
          In order to run the test suite, some testcases are needed and can
          be obtained only from a git repository. The command to download
          them is: <span class="command"><strong>git clone
          git://git.freedesktop.org/git/poppler/test
          testfiles</strong></span>. Then issue: <span class=
          "command"><strong>LC_ALL=en_US.UTF-8 make test</strong></span>.
          Only the Qt5 libraries are tested.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install</kbd>
</pre>
        <p>
          To install the documentation, run the following commands as
          <code class="systemitem">root</code>:
        </p>
        <pre class="root">
<kbd class=
"command">install -v -m755 -d           /usr/share/doc/poppler-0.87.0 &amp;&amp;
cp -vr ../glib/reference/html /usr/share/doc/poppler-0.87.0</kbd>
</pre>
        <h3>
          Poppler Data
        </h3>
        <p>
          If you downloaded the additional encoding data package, install it
          by issuing the following commands:
        </p>
        <pre class="userinput">
<kbd class="command">tar -xf ../../poppler-data-0.4.9.tar.gz &amp;&amp;
cd poppler-data-0.4.9</kbd>
</pre>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make prefix=/usr install</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <em class="parameter"><code>-DCMAKE_BUILD_TYPE=Release</code></em>:
          This switch is used to apply a higher level of compiler
          optimizations.
        </p>
        <p>
          <em class=
          "parameter"><code>-DTESTDATADIR=$PWD/testfiles</code></em>: Tell
          the test programs where the auxiliary files are located.
        </p>
        <p>
          <em class=
          "parameter"><code>-DENABLE_UNSTABLE_API_ABI_HEADERS=ON</code></em>:
          Install some old <span class="application">Xpdf</span> headers
          required by certain programs (e.g. <span class=
          "application">Inkscape</span>).
        </p>
        <p>
          <code class="option">-DENABLE_GTK_DOC=ON</code>: Use this parameter
          if GTK-Doc is installed and you wish to rebuild and install the API
          documentation. If Python 2 is not installed, one script needs to be
          changed: run <span class="command"><strong>sed -i
          '1s/python/&amp;3/' make-glib-api-docs</strong></span> first.
        </p>
        <p>
          <span class="command"><strong>LC_ALL=en_US.UTF-8 make
          test</strong></span>: Run the test suite. The environment variable
          LC_ALL=en_US.UTF-8 is only needed if the default locale does not
          include UTF-8.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">pdfattach, pdfdetach, pdffonts,
              pdfimages, pdfinfo, pdfseparate, pdfsig, pdftocairo, pdftohtml,
              pdftoppm, pdftops, pdftotext, and pdfunite</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libpoppler.so, libpoppler-cpp.so,
              libpoppler-glib.so, and libpoppler-qt5.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/include/poppler, /usr/share/poppler,
              and /usr/share/doc/poppler-0.87.0</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="pdfattach" name="pdfattach"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfattach</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    adds a new embedded file to an existing PDF file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfdetach" name="pdfdetach"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfdetach</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    lists or extracts embedded files from PDF files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdffonts" name="pdffonts"></a><span class=
                    "term"><span class=
                    "command"><strong>pdffonts</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    lists the fonts used in a PDF file along with various
                    information for each font.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfimages" name="pdfimages"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfimages</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    saves images from a PDF file as PPM, PBM, or JPEG files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfinfo" name="pdfinfo"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfinfo</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints the contents of the 'Info' dictionary (plus some
                    other useful information) from a PDF file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfseparate" name="pdfseparate"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfseparate</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    extracts single pages from a PDF file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfsig" name="pdfsig"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfsig</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    verifies the digital signatures in a PDF document.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdftocairo" name="pdftocairo"></a><span class=
                    "term"><span class=
                    "command"><strong>pdftocairo</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts a PDF file to one of several formats (PNG, JPEG,
                    PDF, PS, EPS, SVG) using the cairo output device of the
                    poppler library.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdftohtml" name="pdftohtml"></a><span class=
                    "term"><span class=
                    "command"><strong>pdftohtml</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts a PDF file to HTML.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdftoppm" name="pdftoppm"></a><span class=
                    "term"><span class=
                    "command"><strong>pdftoppm</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts PDF files to PBM, PGM and PPM formats.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdftops" name="pdftops"></a><span class=
                    "term"><span class=
                    "command"><strong>pdftops</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts PDF files to Postscript format.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdftotext" name="pdftotext"></a><span class=
                    "term"><span class=
                    "command"><strong>pdftotext</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    converts PDF files to plain text.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pdfunite" name="pdfunite"></a><span class=
                    "term"><span class=
                    "command"><strong>pdfunite</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    merges several PDF files, in the order of their
                    occurrence on the command line, to one PDF output file.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libpoppler" name="libpoppler"></a><span class=
                    "term"><code class="filename">libpoppler.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains the API functions to render PDF files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libpoppler-cpp" name=
                    "libpoppler-cpp"></a><span class="term"><code class=
                    "filename">libpoppler-cpp.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a C++ backend for rendering PDF files.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libpoppler-glib" name=
                    "libpoppler-glib"></a><span class="term"><code class=
                    "filename">libpoppler-glib.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a wrapper library used to interface the PDF rendering
                    functions with <span class="application">GTK+</span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libpoppler-qt5" name=
                    "libpoppler-qt5"></a><span class="term"><code class=
                    "filename">libpoppler-qt5.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a wrapper library used to interface the PDF rendering
                    functions with <span class="application">Qt</span>5.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-29 12:45:27 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="pixman.html" title="Pixman-0.38.4">Prev</a>
          <p>
            Pixman-0.38.4
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="potrace.html" title="Potrace-1.16">Next</a>
          <p>
            Potrace-1.16
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="graphlib.html" title=
          "Chapter&nbsp;10.&nbsp;Graphics and Font Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
